4.3 HTML

If you have w3m installed on your system, Gnus can display HTML articles in the article buffer. There are many Gnus add-ons for doing this, using various approaches, but there's one (sort of) built-in method that's used by default.

For a complete overview, consult See Display Customization. This section only describes the default method.

mm-text-html-renderer

If set to gnus-article-html, Gnus will use the built-in method, that's based on w3m.

gnus-blocked-images

External images that have URLs that match this regexp won't be fetched and displayed. For instance, do block all URLs that have the string “ads” in them, do the following:

          (setq gnus-blocked-images "ads")

This can also be a function to be evaluated. If so, it will be called with the group name as the parameter. The default value is gnus-block-private-groups, which will return ‘"."’ for anything that isn't a newsgroup. This means that no external images will be fetched as a result of reading mail, so that nobody can use web bugs (and the like) to track whether you've read email.

Also see Misc Article for gnus-inhibit-images.

gnus-html-cache-directory

Gnus will download and cache images according to how gnus-blocked-images is set. These images will be stored in this directory.

gnus-html-cache-size

When gnus-html-cache-size bytes have been used in that directory, the oldest files will be deleted. The default is 500MB.

gnus-html-frame-width

The width to use when rendering HTML. The default is 70.

gnus-max-image-proportion

How big pictures displayed are in relation to the window they're in. A value of 0.7 (the default) means that they are allowed to take up 70% of the width and height of the window. If they are larger than this, and Emacs supports it, then the images will be rescaled down to fit these criteria.

To use this, make sure that you have w3m and curl installed. If you have, then Gnus should display HTML automatically.